
IMPORTANT
=========
The Xfce Evolution theme contains multiple "sub-themes", with one folder for each sub-theme (e.g. the 'Xfce Evolution Bronze' folder for the Xfce Evolution Bronze sub-theme, the 'Xfce Evolution Crux' folder for the Xfce Evolution Crux sub-theme, etc). You may safely remove any sub-theme folders which you do not intend to use after installation, EXCEPT THE MAIN THEME 'Xfce Evolution' FOLDER. The 'Xfce Evolution' folder contains COMMON DATA REQUIRED BY ALL SUB-THEMES, such that deleting this folder will render all sub-themes unusable.

Versions
--------
THE INSTALLATION PROCEDURE MAY CHANGE FOR EACH NEW VERSION, whereby requirements and/or install steps may be added/changed/removed. Please read carefully the 'HISTORY' and 'INSTALL' files each time you install a new release.


DEPENDENCIES
============
- Gtk2 styling requires the Gtk2 'murrine' engine package, installation instructions below
- Gtk styling of Qt5.7+ requires the 'Qt5 style plugins' package, installation instructions below
- Qt5.x apps, at least up to Qt5.10, will produce slightly fuzzy fonts on most Xfce systems because they do not entirely obey the Xfce font settings (see https://bugreports.qt.io/browse/QTBUG-56809); the lines containing '90-qt5.conf' in the installation instructions below will apply/undo a fix for this issue which will work on most modern Xfce systems (spcecifically, on systems which use a typical CRT or LCD screen and which use the default Xfce font highlighting 'slight')

Recommends
----------
The Xfce desktop just isn't complete without the Nemo file manager, installation instructions below


INSTALLATION
============
Please follow _ALL THE STEPS_ in the installation procedure described below; this is necessary in order to properly install all files and dependencies, and to clean up any leftovers from previous installations.
  - note: the Xfce Evolution theme supports several end-user customization options, see 'HACKING' file

Disclaimer
----------
The installation instructions below are believed to be accurate for Xubuntu, Debian, Fedora and FreeBSD at the time of writing; however, testing has been conducted only on Xubuntu-17.04. Please report any issues you may find by opening a ticket at http://xfce-evolution.sourceforge.net and/or in the comments section at https://www.opendesktop.org/p/1191436
  - note: a procedure similar to the ones below should be possible for other distros (e.g. CentOS, Linux Mint, Arch Linux, etc) by changing the corresponding directory and/or package names if/as required for the target OS.

Xubuntu, Debian
---------------
To install/update styling support for gtk2 and qt<5.7 applicatins, run in terminal:
  sudo apt-get install gtk2-engines-murrine # if you are a sudoer (try this first)
    OR
  su -c 'apt-get install gtk2-engines-murrine' # if you know the root password

To install/update styling support for qt5.7+ applications, run in terminal:
  sudo apt-get install qt5-style-plugins # if you are a sudoer (try this first)
    OR
  su -c 'apt-get install qt5-style-plugins' # if you know the root password

To install the Xfce Evolution theme files, run in terminal:
  mkdir -p ~/.themes
  cd ~/.themes
  rm -r Xfce\ Evolution* # remove previous installation
  unzip <FullPathToThemeArchive>/xfce-evolution-<n.n.n>.zip -x 'Xfce Evolution*' # extract theme folders
Then, open 'Settings Manager' and:
  in 'Appearance' select the desired 'Xfce Evolution XXX' theme and the desired icons and font (blends well with 'elementary Xfce darkER' icon set and 'Noto Sans 9' font)
  in 'Window Manager' select the 'Xfce Evolution' style and the desired window title style (blends well with centered title and 'Noto Sans 9' title font)

To fix the qt5 font rendering issue, run in terminal (this step can be performed only at this point, i.e. _after_ installing the Xfce Evolution theme files):
  mkdir -p ~/.config/fontconfig/conf.d
  cp -f ~/.themes/Xfce\ Evolution/90-qt5.conf ~/.config/fontconfig/conf.d/90-qt5.conf # apply qt5 font fix
To undo the fix above (if it turns out to have a negative impact on your system), run in terminal:
  rm ~/.config/fontconfig/conf.d/90-qt5.conf # undo qt5 font fix

Optional: to install/update Nemo, run in terminal:
  sudo apt-get install nemo # if you are a sudoer (try this first)
    OR
  su -c 'apt-get install nemo' # if you know the root password

FreeBSD
-------
There is a port of this theme for FreeBSD; to install/upgrade it, run as root:
  pkg install x11-themes/xfce-evolution # will do nothing if an older version exists, that's ok
  pkg upgrade x11-themes/xfce-evolution # will do nothing if this is the first-time install, that's ok
~~~~~~~
ALTERNATIVELY, if you want the latest version of this theme and can't wait for the port to be updated, you can use this archive to install it from terminal as follows:

To install/upgrade styling support for gtk2 and qt<5.7 applications, run as root:
  pkg install x11-themes/gtk-murrine-engine
  pkg upgrade x11-themes/gtk-murrine-engine

To install/upgrade styling support for qt5.7+ applications, run as root:
  pkg install x11-themes/qt5-style-plugins
  pkg upgrade x11-themes/qt5-style-plugins

FreeBSD 10 and prior's base system 'unzip' does not extract symlinks, such that on FreeBSD 10 and prior you will need to install/upgrade unzip first. On FreeBSD 11 and later, this is not necessary.
To install/upgrade unzip, run as root (only needed for FreeBSD 10 and prior):
  pkg install archivers/unzip
  pkg upgrade archivers/unzip

To install the Xfce Evolution theme files, run as root:
  mkdir -p /usr/local/share/themes
  cd /usr/local/share/themes
  rm -r Xfce\ Evolution* # remove previous installation for all users, if any
  rm -r ~/.themes/Xfce\ Evolution* # remove previous installation for you own user, if any
  unzip <FullPathToThemeArchive>/xfce-evolution-<n.n.n>.zip -x 'Xfce Evolution*' # extract theme files
Then, open 'Settings Manager' and:
  in 'Appearance' select the desired 'Xfce Evolution XXX' theme and the desired icons and font (blends well with 'elementary Xfce darkER' icon set)
  in 'Window Manager' select the 'Xfce Evolution' style and the desired window title style and font (blends well with centered title). 
  note: 'Noto Sans 9', 'DejaVu Sans Book 9' and the 'Bitstream Vera Sans 9' fonts all blend well with this theme.

Finally, to fix the qt5 font rendering issue, run as root:
  mkdir -p /usr/local/etc/fonts/conf.d
  cp -f /usr/local/share/themes/Xfce\ Evolution/90-qt5.conf /usr/local/etc/fonts/conf.d/90-qt5.conf # apply qt5 font fix
To undo the fix above (if it turns out to have a negative visual impact on your system), run as root:
  rm /usr/local/etc/fonts/conf.d/90-qt5.conf # undo qt5 font fix

Optional: to install/upgrade Nemo, run as root:
  pkg install x11-fm/nemo
  pkg upgrade x11-fm/nemo

Fedora
------
To install/update styling support for gtk2 and qt<5.7 applicatins, run in terminal:
  sudo yum install gtk-murrine-engine # if you are a sudoer (try this first)
    OR
  su -c 'yum install gtk-murrine-engine' # if you know the root password

To install/update styling support for qt5.7+ applications, run in terminal:
  sudo yum install qt5-qtstyleplugins # if you are a sudoer (try this first)
    OR
  su -c 'yum install qt5-qtstyleplugins' # if you know the root password

To install the Xfce Evolution theme files, run in terminal:
  mkdir -p ~/.themes
  cd ~/.themes
  rm -r Xfce\ Evolution* # remove previous installation
  unzip <FullPathToThemeArchive>/xfce-evolution-<n.n.n>.zip -x 'Xfce Evolution*' # extract theme folders
Then, open 'Settings Manager' and:
  in 'Appearance' select the desired 'Xfce Evolution XXX' theme and the desired icons and font (blends well with 'elementary Xfce darkER' icon set and 'Noto Sans 9' font)
  in 'Window Manager' select the 'Xfce Evolution' style and the desired window title style (blends well with centered title and 'Noto Sans 9' title font)

Finally, to fix the qt5 font rendering issue, run in terminal:
  mkdir -p ~/.config/fontconfig/conf.d
  cp -f ~/.themes/Xfce\ Evolution/90-qt5.conf ~/.config/fontconfig/conf.d/90-qt5.conf # apply qt5 font fix
To undo the fix above (if it turns out to have a negative impact on your system), run in terminal:
  rm ~/.config/fontconfig/conf.d/90-qt5.conf # undo qt5 font fix

Optional: to install/update Nemo, run in terminal:
  sudo yum install nemo # if you are a sudoer (try this first)
    OR
  su -c 'yum install nemo' # if you know the root password


UNINSTALL
=========
The procedure for uninstalling the 'Xfce Evolution' theme consists of simply deleting all the 'Xfce Evolution XXX' folders from the location where they have been installed (i.e. '~/.themes', or '/usr/local/share/themes', etc).
- note: you do _not_ have to remove the dependencies required by 'Xfce evolution' when you remove the 'Xfce Evolution' theme itself (see the 'DEPENDENCIES' paragraph earlier in this file); moreover, leaving these dependencies installed will provide a better user experience for both a potential future re-installation of 'Xfce Evolution', and for other themes that you already have, or will install, on your system.